 Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved. 

Oracle Network Data Model Editor version 10G 
======================================================

Overview
----------
Oracle Network Data Model Editor is a graphical 
tool that allows customers to view, browse, 
and navigate through data that is stored
in the Oracle Network Data Model.  The user
can also perform analysis on networks (shortest
path, nearest neighbor, minimum cost spanning
tree, etc.) through this tool.  Simple editing
functions like adding and deleting nodes, links,
and paths are also supported.

System Requirements
-------------------
Requirements for installing and running 
Oracle Network Data Model Editor:

1) Java Runtime Environment 1.3.1 or later.
   The Oracle Network Data Model Editor
   is a standalone Java applicaiton.

2) Oracle Database 10G with Network Data Model 

3) Oracle Client 9i or higher with
   JDBC (ojdbc6.jar ) and XML parser
   v2 for Java (xmlparserv2.jar) and 
   xdk.jar in the classpath.


Files shipped
--------------

README.txt
    This text file; a brief description and instructions
    for installing and using this kit.

sdondme.jar
    The jar file containing the classes for the 
    Oracle Network Data Model Editor.

sdoutl.jar
sdonm.jar
sdoapi.jar
    Jar files containing required utility classes.


Execution Instructions
------------------------

1.  With sdondme.jar, sdonm.jar, sdoapi.jar, sdoutl.jar,
    ojdbc6.jar, and xmlparserv2.jar in your classpath,
    execute the following command:

        java oracle.spatial.network.editor.NetworkEditor

    For large networks, you may need to set the java
    heap size accordingly with the -Xms and -Xmx options.
    Type 
        java -X 
    for details.    For example, the following command
        java -Xms100M -Xmx100M oracle.spatial.network.editor.NetworkEditor
    runs the Oracle Network Data Model editor with the
    minumum and maximum heap size set to 100 megabytes.
    


Usage Instructions
-------------------------

To Load a Network:
    Use the "Read network from database" menu item
    from the File menu.  Only networks with category
    SPATIAL (geometry information for the nodes at
    minimum) can be displayed.

Panning and Zooming:
    After a network is loaded, you can use the panning
    and zoom buttons located near the viewing panel
    to view different parts of the network.  The
    "Fit to Window" button allows you to see the entire
    network in the viewport panel.  In addition, you
    can select a rectangular region to view in detail
    by right clicking with the mouse, dragging a 
    rectangular region, and then releasing the mouse
    button when the desired rectangular region appears
    on screen as a turquoise rectangular outline.  This
    feature preserves the viewing window aspect ratio;
    it does not warp or skew geometric features;

Selecting Features:
    Use the mouse cursor to select features (nodes or
    links) that you want more information about.  After
    successfully selecting the feature, the feature will
    be highlighted in the viewport panel.  In addition the
    information panel on the left hand side will display
    various attributes about the feature.  If an attribute
    value is displayed as a button or drop down menu, 
    you can select a related feature and show its information, 
    simply by clicking the button or the drop down item.
    Examples:
        1.  A node may show the ids of its outlinks as a drop down
            menu.  If you select one of the ids, the corresponding
            outlink will be highlighted in the viewport panel and
            its attributes will be displayed in the information
            panel. 
        2.  A link may display the id of its end node as a button.
            Clicking on the button will cause the end node to 
            be highlighted in the viewport panel and its attributes
            to be shown in the information panel.

Viewing specific features, without mouse selection:
    In the View Menu, the "View Node..." and "View Link..."
    allow you to display and highlight specific features
    without having to locate them yourself with the panning
    operations and select them with the mouse cursor.  This
    feature is particularly useful for large networks.

Customizing the symbology:
    You can customize various attributes of how a network
    will look on screen, like node color, link color, labels,
    and background, by clicking on the "Modify symbology..."
    menu item in the View menu.  Once you acheive a look
    that suits your needs, you can save this symbology to 
    a file using the "Save symbology..." menu item in the
    View menu.  Later you can make any network look the
    way you want by loading the symbology that you previously
    saved.  You can do this by using the "Load symbology..."
    menu item in the View menu.

